home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac 1993 September / September 93.iso / Archives / Utilities / Quicktime / Foxbase QuickTime Tools / Read Me First < prev   
Text File  |  1993-03-24  |  5KB  |  113 lines
  1. (Contributor's note: I obtained this from a source at Fox Software (before they were swallowed by MicroSoft.) I thought the net might be interested.)
  2.  
  3.  
  4. About Fox QT.PRG
  5. ------------------
  6. This Demo file was created by Roger Bischoff and shows how to incorporate multi-media QuickTime movies into your FoxBASE+/Mac applications.  This file contains documented PRG, Resource file, ReadMe and 2 sample movies.  QuickTime support in FoxBASE+/Mac comes in the form of an XCMD from the Apple Developer's QuickTime CD-ROM.
  7.  
  8. *******************************************************************
  9. *** You must have the QuickTime Extension from Apple installed  ***
  10. *** before using.  The QT Extension is availble on the          *** 
  11. *** Macintosh Developers forum, GO MACDEV.                      ***   
  12. *******************************************************************
  13.  
  14. Files Included
  15. ---------------
  16. Fox QT.PRG - FoxBASE+/Mac QuickTime interface program.
  17. MOVIEVIEW   - FoxBASE+/Mac resource file containing on-screen
  18.               button images and the QTMOVIE XCMD.
  19. QUICK.DBF   - FoxBASE+/Mac database file containing 3 records
  20.               which point to the movie file location.
  21. QUICK.DBT   - The FoxBASE+/Mac memo file containing references to 
  22.               the movies and the memo field descriptions.
  23.  
  24. Three QuickTime sample movies.
  25.  
  26. BEE FLY         - Color, Silent
  27. W.MOOV          - Color, Silent
  28.  
  29.  
  30. Running the program
  31. --------------------
  32. Double-Click the Fox QT program from the finder, or DO Fox QT.PRG from the Program menu.  When the screen appears, click the picture to get it to play.  At first, you may be prompted to locate the movie files; this is normal.  Just select the movie it is asking for and you will not be asked again.  To Add a new movie to the database, just click the ADD button and select the movie file to add.  In the Movie Attributes screen, select the movie attributes associated with the file "Color, Sound, etc...".  Select OK to return to the main screen.  
  33.  
  34. To quit the program, select the Close box on the window.
  35.  
  36.  
  37. QTMOVIE XCMD
  38. -------------
  39. This XCMD appears on the Apple Developer's QuickTime CD-ROM.  While created with HyperCard in mind, it does work with FoxBASE+/Mac as well.  However, many of the HyperCard parameters are not supported, like WINDOW commands.
  40.  
  41.  
  42. Syntax
  43. -------
  44. The XCMD is called three times.  The first time sets a pointer to the movies location, loads it and displays an image of it on the screen.  The second time the XCMD is called actualls starts the movie playing.  The third and final call to the XCMD closes the movie image and removes it from memory.
  45.  
  46.  
  47. Examples
  48. ---------
  49. This is the exact example as it appears it the Fox QT.PRG program file.  The name and location of the movie is stored in the database field.  When the program is executed, the name and location of the movie is placed into "WHEREIS" which is then passed to the XCMD.
  50.  
  51.  
  52. ***Load the movie and initialize the screen at PIXELS 80,60.
  53. CALL "QTMovie" TO x WITH ;
  54.   "OpenMovie", "Direct",&whereis,"80,60","FastIdle","closeOnFinish"
  55.  
  56. 'CALL "QTMovie"' * Initializes the XCMD.
  57. 'TO x'           * Stores the results of the call to variable X.
  58. '"OpenMovie"'    * Parameter tells the XCMD to open the movie.
  59. '"Direct"'       * Parameter tells the XCMD to place the movie directly on
  60.                    the current output screen.
  61. '&whereis'       * Parameter which tells the XCMD where to find the movie.
  62. '"80,60"'        * Location at which to place the movie in the window - in PIXELS.
  63. '"FastIdle"'     * Play the movie at its normal speed.
  64. '"closeOnFinish"'* When finished, remove the movie from the screen.
  65.  
  66.  
  67. ***Begin playing the movie directly on the screen at its preferred speed.
  68. CALL "QTMovie" WITH "Direct",x,"Idle"
  69.  
  70. 'CALL "QTMovie"' * Initialize the XCMD.
  71. '"Direct"'       * Play the movie on the screen.
  72. 'x'              * Pointer to the location of the movie.
  73. '"Idle"'         * Play the movie.
  74.  
  75.  
  76. ***Movie has finished playing, so it will be cleared from memory.
  77. CALL "QTMovie" WITH "Direct",x,"Dispose"
  78.  
  79. 'CALL "QTMovie"' * Initialize the XCMD.
  80. '"Direct"'       * Movie on the screen.
  81. 'x'              * Pointer to the movie.
  82. '"Dispose"'      * Remove the movie from memory.
  83.  
  84.  
  85. Additional Clauses
  86. -------------------
  87. The QTMOVIE XCMD has many additional clauses which may or may not be helpful when used in FoxBASE+/Mac.  When added to the first XCMD call, these will make the movie behave differently or return useful pieces of information.
  88.  
  89. LOOP - Turns on or off loop mode.  Note, CloseOnFinish must be disabled first.
  90.        
  91. DURATION - Returns the length of the movie.
  92.  
  93. AUDIOLEVEL - Returns the movie's audio level.
  94.  
  95. MUTE - Turns on or off muting.
  96.  
  97. PALIDROME - Turns on or off palidrome mode.
  98.  
  99. RATE - Returns the play rate of the movie.
  100.  
  101. CLOSEONFINISH - Removes the movie image from the screen.
  102.  
  103. FILESIZE - Returns the size of the movie file in bytes.
  104.  
  105.  
  106. Storing a Preview Image of the movie
  107. -------------------------------------
  108. In this application, a preview of the movie is stored in the database and is shown on the screen before the movie is played.  If you would like to do the same, simply use a resource utility to open the movie and Copy a PICT from there into a PICT field in FoxBASE+/Mac.  Not all movie files contain this PICT as a resource.
  109.  
  110.  
  111. Enjoy, Roger.
  112.  
  113.